home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / _archvrs / amiga / archa1.arc / ARCHA.doc < prev    next >
Text File  |  1989-01-29  |  16KB  |  329 lines
  1.                          HERMES' ARCHA  (Version 1.2)
  2.  
  3.                     Copyright (c) 1988-89 A. G. Kartsatos 
  4.  
  5.            (CIS = 76617,121, GEnie = XTH58515, PLink = HERMES)
  6.  
  7.  
  8.                         ***  Shareware Program  ***
  9.  
  10.  
  11.      This program is a utility that provides considerable help to the
  12. user in various archival functions.  It will handle the 9 functions:
  13.  
  14.                              ARC, UNARC, LISTARC,
  15.                              PAK, UNPAK, LISTPAK,
  16.                              ZOO, UNZOO, LISTZOO,
  17.  
  18. provided that the user has the appropriate archiving utilities in his/her
  19. current c directory.
  20.  
  21.      YOU MUST HAVE THE FOLLOWING FILES IN YOUR CURRENT c DIRECTORY:
  22.          
  23.                        PAK, ZOO, ARC, ARCL, URC, BOOZ
  24.  
  25.      The files ARCL, URC and BOOZ are included herein for your convenience.
  26.  
  27.      TO RUN IT FROM THE CLI:        PRESS "ARCHA" OR "RUN ARCHA".
  28.  
  29.      TO RUN IT FROM THE WORKBENCH:  CLICK INTO ARCHA'S ICON.
  30.  
  31.      TO EXIT:                       CLICK INTO THE "X" GADGET 
  32.                                     OR CHOOSE "QUIT" FROM THE MENU.
  33.  
  34.      IMPORTANT NEW FEATURE:  TO STOP ARCHA FROM A FUNCTION LIKE "DELETE"
  35.                              OR "COPY", JUST PRESS THE "TAB KEY".  THIS CAN
  36.                              SAVE A LOT OF FILES WHEN YOU MISTAKENLY TRY
  37.                              TO DELETE GROUPS OF FILES OR COPY THEM INTO
  38.                              THE WRONG DESTINATION PATH.  The program will
  39.                              inform you as soon as the current function gets
  40.                              aborted.
  41.  
  42.      Naturally, these files can be run on their own.  ARCL lists the
  43. files of an ARC file, URC extracts the files of an ARC file and BOOZ
  44. does both these functions for a ZOO file.
  45.  
  46. ***  The URC file is the PKAX program (Copyright (c) 1987 PKWARE Inc.).  It
  47. is a shareware program.  For more information on it and its use, just
  48. press: URC.
  49.  
  50.      The ARCL file was written by Wayne Davison and it is a public domain 
  51. program.  It is the ARCV program.  For more info on it and its use, 
  52. just press: ARCL.
  53.      
  54.      The BOOZ file was written by Rahul Dhesi and it is a public domain
  55. program.  ***
  56.  
  57.      Back to ARCHA.
  58.  
  59.      ARCHA has several other gadgets that the user might want to use in
  60. connection with archiving functions, or even indepedently.
  61.      
  62.      When you first run ARCHA, you get a listing of all your drives and your
  63. floppies along with their AVAILABLE STORAGE in bytes.  
  64.      If you put any drive name in the source gadget and then you press 
  65. RETURN, the program will try to attach to that drive.
  66.      Also, if you CLICK INTO ANY VOLUME NAME of the listing, you get attached
  67. to that volume, provided that that volume exists (disk has not been removed,
  68. etc.).
  69.      Another important feature is that after you have attached to a volume,
  70. you can execute ANY VALID COMMAND as follows: enter the command into the 
  71. command gadget ("C") and press RETURN.
  72.      It is faster to use your archiving functions in RAM:, VD0: or VDK:.
  73.  
  74.      In what follows, CLICK means PRESS THE LEFT MOUSE BUTTON.
  75.  
  76.      MENU:
  77.  
  78.      TOGGLE FONT:  This is a useful menu item when you are using text speed-
  79.                    up programs like FastFonts or BlitzFonts.  You can toggle
  80.                    between the program's built in font and the Topaz 8 font
  81.                    which is built in your Amiga.  Just press LEFT_AMIGA_F
  82.                    (or choose the TOGGLE FONT menu item) to see the font
  83.                    change instantly on the table of files on the left of
  84.                    your screen.  Your text scrolling will be much faster with
  85.                    the Topaz 8 font and one of the above programs.
  86.  
  87.      BUILT IN GADGETS:
  88.  
  89.      ALL:        Highlights all files, except directories.
  90.  
  91.      CLEAR:      Removes the highlighting from all files and directories.
  92.  
  93.      BYTES:      Computes the number of bytes in the selected gadgets.  Use
  94.                  ALL to find out how many bytes are used by the files in the
  95.                  current directory.  Subdirectories are not included.
  96.  
  97.      COPY:       Copies all the files that you have selected into the
  98.                  destination directory that you have entered in gadget D. 
  99.                  ARCHA uses its own COPY routine for this function.
  100.  
  101.      PARENT:     Moves up one step in the directory tree.  It will stop
  102.                  moving when it hits a root directory.
  103.  
  104.      MAKEDIR:    Creates a new directory with the name that you have 
  105.                  entered in the C gadget.  This function will fail if the
  106.                  buffer in the C gadget is empty, or if the filename in
  107.                  the C gadget already exists.
  108.  
  109.      DELETE:     Deletes the selected file or directory.  To delete a direct-
  110.                  ory, CLICK INTO THE DIRECTORY YOU WANT DELETED AND SLIDE THE
  111.                  THE MOUSE OVER TO THE DELETE GADGET.  Then release the
  112.                  mouse.  If your directory is empty, and there is no DOS
  113.                  error, it will be deleted. 
  114.  
  115.      COPYDIR:    This gadget is used to copy a selected directory onto ano-
  116.                  ther directory in the D gadget.  Just CLICK INTO THE DIRECT-
  117.                  CTORY YOU WANT COPIED AND SLIDE THE MOUSE OVER TO THE
  118.                  COPYDIR GADGET.  Then release the mouse.  The entire select-
  119.                  ed directory will be copied into the directory listed
  120.                  in the D gadget.  The file COPY should be in your c direct-
  121.                  ory.  
  122.  
  123.      RENAME:     Renames a selected file or directory.  The new name
  124.                  should be entered in the C gadget on the left.  To rename
  125.                  a directory, just CLICK INTO THE DIRECTORY YOU WANT RENAMED
  126.                  AND SLIDE THE MOUSE OVER TO THE DELETE GADGET.  Then re-
  127.                  lease the mouse.  This will rename your selected directory
  128.                  with the new name in Gadget C.
  129.  
  130.      ATTENTION:  IF YOU WANT A BIGGER WINDOW TO LIST YOUR FILES WHEN YOU
  131.                  USE THE FOLLOWING ARCHIVING FUNCTIONS FROM THE WORKBENCH,
  132.                  PLEASE CHANGE THE DIMENSIONS OF THE "ARCHA WINDOW" BY
  133.                  MODIFYING THE "TOOL TYPES" IN THE ARCHA ICON ACCORDINGLY.
  134.                 
  135.      LISTARC:    Lists the files in an ARC file you have selected.
  136.  
  137.      UNARC:      Unarcs the files of an ARC file you have selected. Then
  138.                  it re-displays the contents of the current directory with
  139.                  the files extracted.  
  140.  
  141.      ARC:        Arcs the files you have selected into an archived file
  142.                  that has the name you have entered in the C gadget.  You
  143.                  don't have to include the ending .ARC in the C gadget.
  144.  
  145.      LISTPAK:    Lists the files in a PAK file you have selected.
  146.  
  147.      UNPAK:      Unpaks the files of a PAK file you have selected.  Notice  
  148.                  that UNPAK does not display the files while it is extracting. 
  149.                  Also, it does not refresh the listing when it is done.  To see
  150.                  the result of UNPAKing, just wait a bit and then click into 
  151.                  the S gadget (containing the current directory) and press
  152.                  <RETURN>.
  153.  
  154.      PAK:        Paks the files you have selected into an archived file
  155.                  that has the name you have entered in the C gadget.  You
  156.                  don't have to include the ending .PAK in the C gadget.
  157.  
  158.      LISTZOO:    Lists the files in a ZOO file you have selected.
  159.  
  160.      UNZOO:      Unzooes the files of a ZOO file you have selected. Then
  161.                  it re-displays the contents of the current directory with
  162.                  the files extracted.  
  163.  
  164.      ZOO:        Zooes the files you have selected into an archived file
  165.                  that has the name you have entered in the C gadget.  You
  166.                  don't have to include the ending .ZOO in the C gadget.
  167.  
  168.      14 DRIVES:  Clicking into any one of these gadgets will list the files
  169.                  in the corresponding volume.  If you don't like the volumes
  170.                  used, I would be happy to configure your copy to your
  171.                  personal liking.  Just call HERMES BBS (see below).
  172.  
  173.      RUN:        This gadget allows you to RUN a highlighted executable
  174.                  program.  Just CLICK into the program's name and then into
  175.                  this gadget.  The file RUN should be in your c directory.
  176.  
  177.      EDIT:       Make sure you have a copy of your favourite Editor renamed
  178.                  EDIT.  This should reside in your current c directory.
  179.  
  180.      SHOW:       Here is a gadget that activates your favourite IFF picture
  181.                  show file named SHOW.  Make sure that the name of your
  182.                  picture showing file is SHOW.
  183.  
  184.      E:          Executes any command that you insert in the C gadget.
  185.  
  186.      V:          Lists all the available volumes along with their available
  187.                  storage in bytes.
  188.  
  189.      X:          Click into it to EXIT the program.  Pressing the TAB KEY has
  190.                  the same effect.
  191.  
  192.      C:          COMMAND gadget.  Here is where you put the output filename
  193.                  for MAKEDIR, RENAME, ARC, PAK and ZOO.  This is also the
  194.                  gadget that ACCEPTS YOUR COMMANDS.  Enter a command in 
  195.                  this gadget and then press <RETURN> in order to execute the
  196.                  command.  Valid commands only, of course.  Please do not
  197.                  use the CD command in this gadget.  The program will get
  198.                  confused by not knowing where it is!  If you want to
  199.                  manually attach to any of your directories/drives, just
  200.                  use the SOURCE gadget ("C") below.
  201.  
  202.      S:          SOURCE gadget.  Here you see the name of the directory that
  203.                  you are currently attached to. Also, if you enter a path
  204.                  name in this gadget and then you press <RETURN>, you get
  205.                  to be attached to that path, provided it is a valid one.
  206.     
  207.      D:          DESTINATION gadget.  Here you enter the name of a desti-
  208.                  nation file or directory.  It is used by COPY and COPYDIR.
  209.  
  210.      The reason the files ARC and ZOO must be included in your current c
  211. directory (even though you might only want to unarc, unzoo, listarc and
  212. listzoo files) is that ARCL and BOOZ "ask questions" (when run from another
  213. utility) when there are duplicate names in the current directory already.
  214.      This program does the following:  Assume that you want to UNARC a file
  215. with the name HERMES.ARC.  When you click the UNARC gadget, the program opens
  216. a file (Ram:Souli) in RAM: and LISTARCS(!) HERMES.ARC into it.  It then tries
  217. to see if any of the files listed in Ram:Souli exist in the current directory.
  218. If this is true, the program runs the ARC program instead of the much smaller
  219. URC program.  The same process takes place when you want to UNZOO a program.
  220.  
  221.      THIS PROGRAM IS NOT A FULL-FEATURED DIRECTORY UTILITY.  FOR SUCH A 
  222. PROGRAM, DOWNLOAD DUHERM27.ARC (DU-HERMES V. 2.7).
  223.  
  224.      ARCHA is a SHAREWARE copyrighted program.  If you find it useful,
  225. please send $15.00 to:
  226.                
  227.                 A. G. Kartsatos   (PLink = HERMES, CIS = 76617,121)
  228.                 8524 Caladesi Island Drive
  229.                 Temple Terrace, FL 33637-7310, USA
  230.  
  231.                              ***  <<<-->>>  ***
  232.  
  233.  
  234.      Programs By HERMES:
  235.  
  236.      COLORLAB.ARC   (This Is A Nice Update To The PALETTA program.  It Allows
  237.                      The User To Identify All Color Shades Of The Amiga
  238.                      Computer, Mix Colors, Get Hex Values For The Colors, and
  239.                      Get Random Colors.  It Also Allows The User To Load An
  240.                      IFF Picture And Modify It At Will (If It Is Of 32 Colors
  241.                      Or Less) By Throwing On The Screen A Nice Palette.  This
  242.                      IFF Picture Can Also Be Reduced To One In Black & White.
  243.                      This Last Feature Can Be Accomplished In 13 Different
  244.                      Ways.  All These Pictures Can Be Saved To A File Or
  245.                      To A Printer)
  246.  
  247.      CALCULA.ARC    (An Expression Parser And A Function Evaluator.  A Really
  248.                      Great Calculator For Your Amiga.  It Will Evaluate 
  249.                      Millions Of Functions F(x,y,z) (Of Up To Three Vari-
  250.                      ables).  Any Depth Of Parentheses!!!)
  251.  
  252.      ROST.ARC       (Reports On Storage And Tasks On Their Windows. Useful!)
  253.  
  254.      LISTA11.ARC    (Very Useful Directory Lister.  Alpha, Bytes, Patterns,
  255.                      CLI, Refresh.  Opens Its Own Window)
  256.  
  257.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy Online! Script Files!)
  258.  
  259.      FORMULA!.ARC   (FORMIDABLE 3D-Grapher In C. It graphs z = f(x,y).  
  260.                      Choice Of Colors.  17 Functions Supported.  An Artist's
  261.                      Tool)
  262.  
  263.      FINANCA.ARC    (Mortgage, Compound Interest And Annuity In Color!)
  264.  
  265.      CONTOURA.ARC   (SPECTACULAR Contour Grapher.  Definitely An Artist's
  266.                     Tool.  CENTER, ZOOM IN, ZOOM OUT, FLOWING PALETTE,
  267.                     SCALING.  An Important Artist's Tool!)
  268.  
  269.      DUHERM27.ARC   (Beautiful Directory Utility.  A Multitude Of Functions.
  270.                     72 Gadgets Out Of Which 48 Are User-configurable! 
  271.                     One Of The Major Powerful DirUtils For The Amiga)
  272.  
  273.      CYCLER1.ARC    (This Program Will Cycle Your IFF Pictures (<=32 Colors)
  274.                     In Two Different Modes (Straight And Reverse) And Three
  275.                     Different Speeds.  Great For Creating Motion Via 
  276.                     Cycling!)
  277.  
  278.      VIEWOVER.ARC   (This Is The Program View (V. 1.8) With Overscan 
  279.                     Capability By HERMES.  Very Small (About 6K) And Very
  280.                     Convenient)
  281.  
  282.      HERMIT.ARC     (This Program Allows You To Save/Cycle Your Front Screen.
  283.                     It resides In The Background And "Listens" To Your Key-
  284.                     board For HOT KEYS.  Nice And Only About 15K Long)
  285.  
  286.      SIMPLIC1.ARC   (The Simplex Method Of Linear Programming. The
  287.                     Complete Program Handles Simplexes Of Up To 30 Un-
  288.                     knowns And Up To 30 Constraints.  It Will Also Load
  289.                     And Save Simplexes.  The Best Simplex Program For
  290.                     Your Amiga.  
  291.                     [This Is The Demo Version Of The Commercial Program
  292.                     SIMPLICA Available From The Address Below At $30.00]
  293.  
  294.      ICONLAB2.ARC   (The Definitive Work On Icons For The Amiga Computer.
  295.                     It Supports:
  296.  
  297.                                      CUT/SAVE ICONS, 
  298.                                      ICON->BRUSH, 
  299.                                      BRUSH->ICON, 
  300.                                      CUT/SAVE BRUSHES, 
  301.                                      8-COLOR ICONS, 
  302.                                      SPLIT ICONS, 
  303.                                      JOIN ICONS,
  304.                                      MODIFYING OF ICON DATA,
  305.                                      CHANGING RESOLUTION ON THE FLY, etc)
  306.  
  307.                     [This Is The Demo Version Of The Commercial Program
  308.                     ICONLAB Available From The Address Below At $30.00]
  309.  
  310.  
  311.      FOR SUPPORT, call HERMES BBS in Tampa, FL, USA.  It is a  
  312. private bulletin board with 1800 files online and a healthy message base.
  313.  
  314.      HERMES BBS Telephone No.: 813-985-7624  (2400, PC Pursuitable).
  315.  
  316. DISTRIBUTION
  317. ============
  318.  
  319.      Feel free to distribute ARCHA, with this doc intact, to any bulletin
  320. boards and non-profit establishments in the US and abroad.
  321.      You are also allowed to upload this program to major electronic boards
  322. like Compuserve, Delphi, GEnie, PLink, etc.
  323.      The inclusion of ARCHA, or any part of it, in any form in a commercial
  324. package, or its use for any commercial purposes, requires the explicit
  325. permission of the author.
  326.      The nationally and internationally sold disks with Amiga software are
  327. considered commercial packages by this author.  Only The Amiga User Group
  328. disks are excluded.
  329.